home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 22 / AACD 22.iso / AACD / Utilities / Wibby / Wibby.readme < prev    next >
Encoding:
Text File  |  2001-05-14  |  6.2 KB  |  149 lines
  1. Short:    Small, quick, and useful taskbar util
  2. Uploader: ah210@chebucto.ns.ca
  3. Author:   ah210@chebucto.ns.ca
  4. Type:     util/boot
  5. Version:  1.0
  6.  
  7. Wibby is (c) 2000-2001 John Mason
  8.  
  9. Please read the Changes file for info on new features and bugfixes.
  10.  
  11. Wibby is another taskbar type program, but my main goal in writing it was to make
  12. something that was small, fast, and useful.  This version should be considered a
  13. work in progress, although it is 99% functional.  I decided to upload it to Aminet
  14. and see if anyone likes it or not; so please let me know if you do!
  15.  
  16. == DISCLAIMER ==================================================================
  17.  
  18. As usual, no one, including myself, will be held responsible for any direct or
  19. indirect damages of any kind resulting from the use of Wibby (or the reading
  20. of this text file for that matter!).
  21.  
  22. ================================================================================
  23.  
  24. Installation:
  25.  
  26.   Put Wibby in your WBStartup drawer. :)
  27.  
  28. Setup:
  29.  
  30.   Wibby can be configured using Tooltypes.  Currently they are:
  31.  
  32.   OPENON - The screen(s) to open on.  The values for this tooltype are:
  33.  
  34.     ALL        - Wibby will open on any and all screens.
  35.     WORKBENCH  - Wibby will only open on the Workbench Screen.
  36.     THESE      - Wibby will only open on screens you specify (see below)
  37.     NOTTHESE   - Wibby will open on all screens except those you specify (see
  38.                  below)
  39.  
  40.     For the THESE and NOTTHESE settings, you must also specify a list of
  41.     screennames.  To do this, add some tooltypes like these:
  42.  
  43.     SCREEN1=Workbench Screen
  44.     SCREEN2=Someother Screen
  45.     etc.
  46.  
  47.     Note that the screen name used here should match the screen's default title,
  48.     which is shown in brackets following the screen name in screens mode unless
  49.     the default title is the same as the screen's current title.  Since the screen
  50.     associated with a given program can change, future versions may check screens
  51.     by taskname instead...
  52.  
  53.   LEFTOUTVOLNAME - The volume to use for the left out icon mode (see below).
  54.                    Note the volume name should NOT include a colon.
  55.  
  56.   HELPSTAYS - If this is set to YES, then one the help box has opened, it will
  57.               stay open, even if you switch modes.
  58.  
  59.   HELPTIME  - Use this to specify in tenths of a second how long Wibby should
  60.               wait before opening its help box.  If this is not specified, Wibby
  61.               will default to a one second delay.
  62.  
  63.   MODERESET - This tooltype causes Wibby to return to a default mode each
  64.               time you use it.  If this tooltype is present, you can also
  65.               add the DEFAULTMODE tooltype, and give it one of these values:
  66.  
  67.               WINDOWS     - Default to windows mode
  68.               SCREENS     - Default to screens mode
  69.               COMMODITIES - Default to commodities mode
  70.  
  71.   GUI Pen Tooltypes:
  72.  
  73.   Wibby allows you to set the colours used for its interface.  There are
  74.   seven tooltypes for doing this:
  75.  
  76.   TEXTFG - The colour for each button's title
  77.   TEXTBG - The background for each button
  78.   SHINE  - The colour for the shine of each button (top and left sides)
  79.   SHADOW - The colour for the shadow of each button (bottom and right sides)
  80.   HELPFG - The colour for the help box's text
  81.   HELPBG - The colour for the help box's background
  82.   HELPBORDER - The colour for the help box's border
  83.  
  84.   To set the colour to use for each of these items, set the tooltype value
  85.   to the RGB value you want, ie:
  86.  
  87.   "TEXTFG=255,255,255" for full white
  88.   "TEXTFG=0,0,0"       for full black
  89.   "TEXTFG=255,0,0"     for full red
  90.  
  91.   Wibby will try to find the best pen in the screen's palette to represent
  92.   your chosen colour, so the colours may not be exactly the same on each
  93.   screen.
  94.  
  95.  
  96. Usage:
  97.  
  98.   Once installed, Wibby will appear when you move the mouse to the bottom of the
  99. Workbench screen.  If you need to point at the bottom of the screen without
  100. activating Wibby, hold down the left shift key.  When Wibby opens, there should
  101. be several buttons along the bottom of the screen, one for each of the currently
  102. available objects, depending on the current mode.
  103.  
  104. There are four modes -- Windows, Screens, Commodities, and Left out icons, so
  105. if you are in windows mode (the default) then you'll see a button for each
  106. window open on the Workbench screen.  As you point at one of the buttons, the
  107. Workbench screen's title bar will show you the full title of the object you're
  108. pointing at, as well as the mode that you are currently using.
  109.  
  110. Clicking on any button should bring that window to the front, and holding shift
  111. while clicking a button should send that window to the back.  Also, holding alt
  112. while clicking a button should zip the window, as if you had clicked the zoom
  113. gadget.  In other modes, things work slightly differently:
  114.  
  115. Mode               Click              Shift Click        Alt Click
  116. ================   ================   ======--========   =============
  117. Screens            Bring screen       N/A                N/A
  118.                    to front
  119.  
  120. Commodities        Show commodity's   Hide commodity's   N/A (kill commodity?)
  121.                    interface          interface
  122.  
  123. Left out icons     Run program        N/A                N/A
  124.  
  125.  
  126. Note that the left out icons mode does not work for all left out icons -- it
  127. tries to Execute() the left out icon, so for it to work properly, the icon must
  128. be for an executable program, and as well the program must run from outside of its
  129. own directory.  Finally, it only shows left out icons for the volume named "Work".
  130. In future versions this mode should be a little more complete if anyone actually
  131. uses it :)
  132.  
  133. To switch modes, simply click the right mouse button once.
  134.  
  135. Wibby has a help feature for buttons that are too small to read easily --
  136. if you keep the mouse pointer on Wibby for a certain period of time,
  137. a help box will appear next to the mouse pointer that gives you the full
  138. name of the object you're pointing at.  It will float left and right as
  139. you move to mouse so you can see the full names of every item.
  140.  
  141. Contact:
  142.  
  143.   If you use Wibby regularly, please send me an email.  My address is
  144.   ah210@chebucto.ns.ca.  The more feedback I get, the better motivated I'll
  145.   be to keep working on the program.
  146.  
  147.   Also, take a look at my website at http://chebucto.ns.ca/~ah210 for some
  148.   of my other programs.
  149.